home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / answers / alt / macintosh / alt-sources-mac < prev    next >
Internet Message Format  |  1994-04-07  |  16KB
  1. Path: bloom-beacon.mit.edu!news.media.mit.edu!uhog.mit.edu!news.kei.com!ub!dsinc!netnews.upenn.edu!juliet.sas.upenn.edu!netaxs.com!f8dy
  2. From: f8dy@netaxs.com (Mark Pilgrim)
  3. Newsgroups: alt.sources.mac,alt.answers,news.answers
  4. Subject: alt.sources.mac FAQ
  5. Followup-To: poster
  6. Date: 7 Apr 1994 18:44:52 GMT
  7. Organization: Net Access - Philadelphia's Internet Connection
  8. Lines: 344
  9. Approved: news-answers-request@MIT.Edu
  10. Message-ID: <2o1kb4$pf@netaxs.com>
  11. NNTP-Posting-Host: access.netaxs.com
  12. Summary: please read this before posting anything to alt.sources.mac
  13. X-Newsreader: TIN [version 1.2 PL2]
  14. Xref: bloom-beacon.mit.edu alt.sources.mac:483 alt.answers:2353 news.answers:17788
  15.  
  16.  
  17. Archive-Name: macintosh/alt-sources-mac
  18. Submitted-by: f8dy@netaxs.com (Mark Pilgrim)
  19. Last-modified: 7-apr-94
  20. Version: 6
  21.  
  22. This compilation is intended to answer some of the most frequent questions
  23. about alt.sources.mac.  It is posted every week (usually Thursday) to
  24. alt.sources.mac and every other week (usually Thursday) to alt.answers and
  25. news.answers.  Please read it thoroughly before posting _anything_ to
  26. alt.sources.mac.  If you've read it and still aren't clear on why/what/how
  27. to post, e-mail the FAQ maintainer (f8dy@netaxs.com) or the group's creator
  28. (dnebing@andy.bgsu.edu) instead of posting a "What do I do" post.
  29.  
  30. Many FAQs, including this one, are available on the archive site rtfm.mit.edu
  31. in the directory pub/usenet/news.answers. The name under which a FAQ is
  32. archived appears in the "Archive-Name:" line at the top of the article.  This
  33. FAQ is archived as "macintosh/alt-sources-mac".
  34.  
  35. To find a particular topic by number, search for the number surrounded by
  36. rounded parentheses; i.e. to find information about acceptable content of
  37. posts, search for "(2.3)".  To find references to a topic, search for the
  38. number surrounded by less-than and greater-than signs; i.e. to find references
  39. to acceptable content of posts, search for "<2.3>".
  40.  
  41. Table of contents:
  42. -----------------
  43. 1. Why (and why not) to post to alt.sources.mac
  44.    1.1. Reasons to post here / general introduction
  45.    1.2. Reasons to post elsewhere
  46.    1.3. Reasons alt.sources.mac is called alt.sources.mac and not
  47.         anything else
  48. 2. What (and what not) to post to alt.sources.mac
  49.    2.1. Acceptable platforms/systems/environments
  50.    2.2. Unacceptable platforms/systems/environments
  51.    2.3. Acceptable content of posts
  52.    2.4. Unacceptable content of posts
  53. 3. How (and how not) to post to alt.sources.mac
  54.    3.1. General posting formatting guidelines
  55.    3.2. Small posts, snippets, cross-posts from other newsgroups
  56.    3.3. Larger posts
  57. 4. FTP sites
  58.    4.1. FTP sites which carry alt.sources.mac archives
  59.    4.1.1. FTP sites which will carry alt.sources.mac archives real soon now
  60.    4.2. FTP sites which carry other Macintosh source code
  61. 5. Things not included in this classification
  62.    5.1. Copyrights of posts
  63.    5.2. FAQ credits
  64.    5.3. ObSource
  65.  
  66. (1.1) Reasons to post here / general introduction
  67.  
  68. The alt.sources.mac newsgroup is intended to be a repository for Macintosh
  69. source code of all sorts that people wish to distribute and share with others.
  70. There are no restrictions on the type of source code you can post here --
  71. any mac, any language, any system version, any purpose. (see <2.1> and <2.3>
  72. below for details).
  73.  
  74. A common reason to post to alt.sources.mac is when you are posting a useful
  75. bit of source code to some other newsgroup, and you think that it might prove
  76. useful to other people in the future, in which case you can cross-post it here.
  77.  
  78. Alt.sources.mac is unmoderated, so your source code will be distributed
  79. throughout the USENET (or, at least, the portion of the USENET that receives
  80. alt.sources.mac -- see <1.2> below) immediately, without having to wait for a
  81. moderator's approval, like you have to do for some of the other newsgroups.
  82.  
  83. Furthermore, alt.sources.mac is archived at several anonymous ftp sites (see
  84. <4.1> below), so people will be able to get your software from the archive
  85. after you've posted it, rather than having to ask you to mail it to them.
  86.  
  87. Finally, you might have a snippet of mac source code that is really too
  88. small to submit as a package to one of the other major source newsgroups (see
  89. <3.2> below).
  90.  
  91. (1.2) Reasons not to post here
  92.  
  93. Alt.sources.mac IS NOT for requests for source code; the alt.sources.wanted
  94. newsgroup is for that.  Alt.sources.mac IS NOT for comments and discussion
  95. about source code, even source code posted in alt.sources.mac; the
  96. alt.sources.d newsgroup is for that.  Only source code should be posted to
  97. alt.sources.mac.
  98.  
  99. Alt.sources.mac isn't as widely propagated as the source newsgroups in the
  100. "comp" hierarchy, since more sites tend to get "comp" than "alt".  Therefore,
  101. if you want your source code to have as wide a distribution as possible, you
  102. might want to use the comp.sources.mac newsgroup instead of, or in addition
  103. to, alt.sources.mac.
  104.  
  105.  
  106. (1.3) Reasons alt.sources.mac is called alt.sources.mac and not anything else
  107.  
  108. A bunch of clever linguists have asked on alt.sources.mac why the group is
  109. not called alt.source.code.mac, alt.source-code.mac, or alt.sourcecode.mac.
  110. Some people feel that "sources" is an ambiguous term which implies that
  111. people can freely post questions like "Where can I find X?"  In fact, they
  112. are right, but their linguistic arguments are largely irrelevant.
  113.  
  114. Alt.sourcecode.mac does not fit into the Usenet naming hierarchy.  Like it
  115. or not, there is an established naming scheme, and source groups like
  116. alt.sources, alt.sources.amiga, alt.sources.d, alt.sources.index,
  117. alt.sources.patches, and alt.sources.wanted were around long before
  118. alt.sources.mac came into existence.  There is no alt.sourcecode.* hierarchy.
  119. This name policy is enforced by a group of influential news administrators
  120. who manage the large sites (like uu.net) that directly or indirectly provide
  121. newsfeeds to most of the world.  This naming scheme has been around for a
  122. long time, is very widely accepted, and was an important consideration when
  123. these people agreed to create alt.sources.mac.
  124.  
  125. In short, there is nothing we can do about the name "alt.sources.mac".  It
  126. may be confusing to people who are unfamiliar with the group's purpose, but
  127. that's what FAQs are for.  If you're really adamant about trying to change
  128. the name, please discuss it in alt.config, NOT in alt.sources.mac.
  129.  
  130.  
  131. (2.1) Acceptable platforms/systems/environments
  132.  
  133. Source code can be for the entire Macintosh line (including the Centris and
  134. Quadra lines), Newton, and the new PowerMac line of Macintosh computers.
  135.  
  136. Source code can be for any Macintosh operating system (6, 7, 7Pro, etc.), as
  137. well as Bento, A/UX (as long as the source is A/UX specific and does not apply
  138. to UN*X in general), etc.
  139.             
  140.  
  141. (2.2) Unacceptable platforms/systems/environments
  142.  
  143. Anything not mentioned in <2.1> above.  No UN*X, VAX, IBM, Apple //, TRS-80,
  144. Commodore, Amiga, or HP programs allowed.  Really.  All these other
  145. platforms have their own newsgroups or list-servers.  If it's not for the
  146. Mac, Newton, or PowerMac, it doesn't belong in alt.sources.mac.
  147.  
  148.  
  149. (2.3) Acceptable content of posts
  150.  
  151. Alt.sources.mac is EXCLUSIVELY for posting source code.  The source code
  152. may be in any form, textual or otherwise (i.e. Prograph files).  Also
  153. appropriate sources would include:
  154.  
  155. Resources:  Resources used in Macintosh programs.  These can include
  156.             CDEF's, MDEF's, as well as any other resource.
  157.  
  158. Scripts:    Scripts for either AppleScript, QuicKeys, Userland
  159.             Frontier, as well as any other scripting system.
  160.  
  161. Projects:   This includes project files for the Think compilers, as
  162.             well as Makefiles, AppMaker or Marksman project files, etc.
  163.  
  164. Source code can be for a full software product, library, patches, glue, or
  165. even code snippets.  See <3.3> below for how to post large archives.
  166.  
  167. Note on project files: in some programming environments (e.g. THINK C), the
  168. newest version of a project file is not backwardly-compatible.  For instance,
  169. THINK C 6 project files can not be read by THINK C 5.  Along with the project
  170. file, you should include a text file in the archive explaining how to set up
  171. the project from scratch.  
  172.  
  173.  
  174. (2.4) Unacceptable content of posts
  175.  
  176. Do nthat is not yours unless you have
  177. permission from the original author.  This includes posts you see on
  178. other newsgroups; always consult the original author before cross-posting.
  179.  
  180. Do not post something that can only be decompressed with a commercial
  181. decompression program.  If you insist on compressing your source archive
  182. with a commercial compression program, make sure that either (a) it can be
  183. decompressed with a free/shareware program, or (b) it is self-extracting.
  184.  
  185. Do not post source code to viruses or intentionally malicious software.
  186.  
  187. Do not post anything that doesn't include some sort of Mac source code (see
  188. <1.3>, <2.1> above).
  189.  
  190.  
  191. (3.1) General format for all posts
  192.  
  193. Choose a good subject line for your posting that accurately describes what
  194. it contains.  The alt.sources.mac archive site generates its indices of the
  195. newsgroup from the subject lines of the postings in it, so try to make sure
  196. that there are relevant keywords in your subject that people can search for
  197. when looking for your source code later.  For source code archives spread
  198. over several posts (see <3.3> below), the subject lines should include not
  199. only the archive name, type, and platform, but also the part number:
  200.         Ghost 1.0 (word game, THINK C, part 0 of 10)
  201.         Ghost 1.0 (part 1 of 10)
  202.         ...
  203.         Ghost 1.0 (part 10 of 10)
  204.  
  205. Put a Followup-To: header line in your posting which directs followups
  206. somewhere other than alt.sources.mac.  This is especially important if you
  207. cross-post your alt.sources.mac posting from some other newsgroup, because
  208. people will often respond to the posting in that newsgroup without realizing
  209. it was cross-posted to alt.sources.mac.
  210.  
  211. At the top of your posting, separated from the main header of the posting
  212. by a blank line, include "Archive-name:" and "Submitted-by:" lines:
  213.         Archive-name: ghost-10.hqx
  214.         Submitted-by: f8dy@netaxs.com
  215.  
  216. The "name" on the first line should be a short one-word string that can serve
  217. as a "tag" for the package.  If your post is a complete program with a unique
  218. name, you can just use the name of the program as the archive name.  If you
  219. are posting a patch to a previously posted bit of source code, you would do
  220. something like "name/patchN", where N is the number of the patch.  If you post
  221. source code in multiple parts, do "name/part1", "name/part2", etc.  The second
  222. line should contain a return mail address for you.
  223.  
  224. This informational header (note that it is an auxiliary header, in the body of
  225. the posting, NOT part of the main message header) is used by some automatic
  226. archiving software to maintain alt.sources.mac archives automatically.  There
  227. are other useful fields you may want to put in the auxiliary header; if you
  228. are curious, see the documentation for the "rkive" program in the
  229. comp.sources.misc archives to find out what they are.
  230.  
  231. Other than the informational header, each post should include the following
  232. additional information about the content of the post: the type of code, a
  233. brief description of the code, the language of the code, and (if necessary)
  234. the specific programming environment the code was written in (e.g. THINK C
  235. vs. MPW C, QuickBASIC vs. Visual BASIC).  Answer all these questions early
  236. in the post; people should not have to search through the entire package
  237. just to figure out what it is.
  238.  
  239. For large posts (more than a few pages), this information should constitute
  240. the entire first post (part 0).  See <3.3> below for details.
  241.  
  242.  
  243. (3.2) Small posts, snippets, cross-posts from other newsgroups
  244.  
  245. Any small amount of source code (less than a few pages) can be posted as
  246. straight text.
  247.  
  248. If you post a single function to comp.sys.mac.programmer and feel it would
  249. serve the general community to have it on alt.sources.mac (and therefore
  250. archived on ftp sites around the world as well), cross-post it with a
  251. descriptive subject line.  Please remember to include a "Followup-To:" line
  252. to the original newsgroup or your own e-mail address.
  253.  
  254. If the source code, however small, relies on resources in a resource file,
  255. or if it is in two or more separate files, use the format for larger posts
  256. (see <3.3> below).
  257.  
  258.  
  259. (3.3) Large posts
  260.  
  261. Large source archives (for instance, code and resources for an entire
  262. program) are problematic, because some users must download an entire news
  263. article to read it.  Also, some newsreaders will cut off very large posts
  264. (over 1000 lines).  Therefore, put all relevant information about the
  265. source code in the first post, labeled "part 0 of n", where n is the number
  266. of posts the source code is split into.
  267.  
  268. After the informational post, the source code itself should be compressed
  269. and BinHexed.  (Compact Pro and Stuffit Lite are the favored compression
  270. programs, and the compressed archive should then be converted to BinHex 4.0
  271. format with any program that does that sort of thing.  Compact Pro and
  272. BinHex both do this quite well.)
  273.  
  274. The BinHex file should be split into sections of no more than 800 lines each.
  275. In unix, this can be accomplished with the command
  276.         split -800 filename
  277.  
  278. Each post should have a subject line that contains the part number ("part 0
  279. of n" for the informational post, "part 1 of n" for the first 800 lines of
  280. BinHexed source code, "part 2 of n", etc.).  Remember, these subject lines
  281. are used as indices when your source code gets archived on ftp sites (see
  282. <4.1> below).
  283.  
  284.  
  285. (4.1) FTP sites which carry alt.sources.mac archives
  286.  
  287. ftpbio.bgsu.edu (129.1.252.66) - /pub/alt.sources.mac
  288.  
  289. mac.archive.umich.edu (141.211.120.11) - /mac/development/source (entire
  290. programs) and /mac/development/source/snippets (code fragments).
  291.  
  292.  
  293. (4.2) FTP sites which carry other Macintosh source code
  294.  
  295. sumex-aim.stanford.edu (36.44.0.6) - /info-mac/dev/src
  296.  
  297. ftp.apple.com (130.43.2.3) - /dts/mac - Apple's primary FTP site.  It has
  298. lots of goodies that you won't find anywhere else, sample code and snippets
  299. and tech notes, programming tools and so on.
  300.  
  301. seeding.apple.com (130.43.3.3) - Not much code here, but it does have the
  302. MacTCP docs.
  303.  
  304. nic.switch.ch (130.59.1.40) - /software/mac/src - This is a fountain of
  305. source of all kinds, perhaps the most comprehensive source code archive for
  306. the Mac. It has source for lots of unix ported utilities as well as lots of
  307. "normal" mac source code.
  308.  
  309. ftp.acns.nwu.edu (129.105.16.52) - /pub - Source code for Disinfectant 2.4
  310. (except the anti-virus code) and NewsWatcher.
  311.  
  312. ftp.qualcomm.com (192.35.156.5) - /mac/eudora - Source code for Eudora.
  313.  
  314. ftp.ncsa.uiuc.edu (141.142.20.50) - /Mac - lots of NCSA source code
  315. (Telnet, Mosaic etc).
  316.  
  317. redback.cs.uwa.edu.au (130.95.80.61) - /others/PeterLewis - stuff written
  318. by Peter Lewis.
  319.  
  320. ftp.brown.edu (128.148.176.55) - /pub/tcl - classes for use with Think Class
  321. Library.
  322.  
  323. ics.uci.edu (128.195.1.1) - /mac/think-c - Home of the think-c mailing list,
  324. has lots of code & classes, etc., for THINK C.
  325.  
  326. ftp.cc.umanitoba.ca (130.179.16.24) - /Mac-Develop/Source - Home of the
  327. develop mailing list, also has lots of misc stuff not found elsewhere.
  328.  
  329.  
  330. (5.1) Copyrights of posts
  331.  
  332. Source code that is posted on alt.sources.mac is copyrighted by the author
  333. unless otherwise stated.  Permission must be granted by the author of the
  334. code before being submitted by a second party.  Source code that is
  335. distributed via this newsgroup can be archived and distributed in any form
  336. as long as the source is in its original posted form.
  337.  
  338.  
  339. (5.2) FAQ credits
  340.  
  341. This FAQ compilation is maintained by Mark Pilgrim (f8dy@netaxs.com).  It
  342. draws information and phrasing from many sources, including:
  343.   - the original welcome message for alt.sources.mac, by Dave Nebinger
  344.   - the original welcome message for alt.sources, by Jonathan Kamens
  345.   - the original RFD for alt.sources.mac, by Dave Nebinger
  346.   - the beta FAQ compilation for alt.sources.mac, by Peter N. Lewis
  347.  
  348.  
  349. (5.3) ObSource
  350.  
  351. Since alt.sources.mac is exclusively for posting Macintosh source code, here
  352. is some C code to convert a char to its rot-13 equivalent:
  353.  
  354. unsigned char Rot13(unsigned char theChar)
  355. {
  356.   return (((theChar|0x20)<'a') || ((theChar|0x20)>'z')) ? theChar :
  357.          ((theChar|0x20)<='m') ? theChar+13 : theChar-13;
  358. }
  359.  
  360.